home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d18 / opbonus.arc / CALIBRAT.ARC / CALIBRAT.DOC next >
Text File  |  1991-03-20  |  5KB  |  103 lines
  1. CALIBRATE - Program to Create and Configure a BasePrinter Stream
  2. ----------------------------------------------------------------
  3. Richard Sadowsky
  4. TurboPower Software
  5. 1/90
  6. Version 1.0
  7. Released to the public domain
  8.  
  9.  
  10. Overview
  11. ------------------------------------------------------------------------------
  12.  
  13. The main purpose of CALIBRATE is to illustrate how to best choose a printer
  14. test number for BiosPrinter instances. It is also useful for creating a stream
  15. file that contains the calibrated BasePrinter (BiosPrinter or DosPrinter).
  16.  
  17. When configuring a BiosPrinter, CALIBRATE has the ability to determine the
  18. appropriate printer test number to use with the given printer. This is a nice
  19. feature, since printer tests are a touchy issue!
  20.  
  21. This program is intended as an example of how auto printer test selection can
  22. be implemented. Since it is public domain, you may do with it what you wish,
  23. but be warned - it is a sample program by design and may not be up to
  24. production quality!
  25.  
  26.  
  27. Running CALIBRATE
  28. ------------------------------------------------------------------------------
  29.  
  30. When CALIBRATE is run, you are first prompted for the stream file name. If you
  31. specify a filename that already exists, you will be asked if it should be
  32. overwritten.
  33.  
  34. After specifying a filename, you enter a data entry screen. The first question
  35. is "Use Bios Services?" This is a True/False field. If True is specified (the
  36. default), then CALIBRATE will create a BiosPrinter object. If False is
  37. specified, then a DosPrinter will be created. Your answer to this question
  38. will dictate which remaining fields on the entry screen are required.
  39.  
  40.  
  41. Configuring DosPrinter's
  42. ------------------------------------------------------------------------------
  43.  
  44. If you specify False to the Use Bios Services field, then you will be asked
  45. for a printer name. This name may be any valid DOS filename (optionally
  46. including drive and path), or any DOS character device (PRN, LPT1, LPT2, LPT3,
  47. NUL). This is all CALIBRATE needs to know about a DosPrinter.
  48.  
  49.  
  50. Configuring BiosPrinter's
  51. ------------------------------------------------------------------------------
  52.  
  53. If True is specified for Use Bios Services, then you will be asked for the LPT
  54. number of the printer. Enter 1 for LPT1, 2 for LPT2, or 3 for LPT3. No other
  55. numbers are valid choices. The proper selection of the port is especially
  56. important if the "Auto Test Selection" feature is used (see below).
  57.  
  58. The final field prompts for a printer test number. The printer test number is
  59. used by a BiosPrinter instance to determine if a printer is ready, and whether
  60. a printer operation succeeded or failed. Valid printer test for Object
  61. Professional 1.00 are in the range of 0..4 (see OPPRNLOW section of OPRO
  62. manual for more information on the meaning of the printer test number). While
  63. the cursor is on this printer test field, you may press F10 to have CALIBRATE
  64. perform its "Auto Test Selection."
  65.  
  66.  
  67. Auto Test Selection for BiosPrinter's
  68. ------------------------------------------------------------------------------
  69.  
  70. Determining a printer test that will work for a given hardware setup can be a
  71. difficult chore. CALIBRATE can attempt to select an appropriate printer test
  72. for you. In order to do so, it needs your help. You will be asked to create
  73. certain conditions related to the printer, and press a key when those
  74. conditions have been created. It is important that you do create the exact
  75. condition asked for, or the automatic test selection may not work.
  76.  
  77. The first printer condition you are asked to create is "online and ready with
  78. paper loaded." The next condition is "offline" (sometimes referred to as
  79. "selected"). The offline state means that printer is powered on, but not
  80. selected. The next condition prompted for is "out of paper." This means you
  81. should place the printer online again (selected), and remove the paper. The
  82. final condition is "powered off." This means the printer is turned off
  83. completely.
  84.  
  85. The auto test selection works by applying each printer test while the printer
  86. is in each of the conditions. It stores the results, and when the test is
  87. complete they are analyzed. This is done by assigning a weight to each of the
  88. conditions. For each printer test, the list of results is scanned, adding the
  89. weight for each test that properly determined the state of the printer. The
  90. printer test with the highest score is deemed to be the best test. There is a
  91. minimum score that must be surpassed, or no test will be considered
  92. acceptable. In this case, you will be informed of this condition (through a
  93. "dialog window") and zero will be placed in the printer test field (zero
  94. indicates not to use a printer test).
  95.  
  96. The reason why the printer conditions are given weights is to properly
  97. evaluate the importance of each test. It is mandatory that the test be able to
  98. determine when a printer is online and ready. In order to be acceptable, the
  99. printer must also be able to detect whether the printer is offline or out of
  100. paper. The powered off condition is given a very low weight since the results
  101. of the Bios Printer Status function call are undefined for a powered off or
  102. non-existent printer.
  103.